Skip to main content

FAQ - Dataoris Webhook Integration

Frequently asked questions about Dataoris integration​

General​

What is needed to start using Dataoris?​

To use Dataoris, you need:

  1. Integrate the Group Link SDK into your mobile application (Android and/or iOS)
  2. Provide a webhook endpoint (HTTPS) to receive events
  3. Define the H3 cells (Cell IDs) you want to monitor
  4. Wait for configuration by the Group Link team

Can I use Dataoris without integrating the SDK?​

No. SDK integration is mandatory. It is through the SDK that geolocation events are captured and sent. Without the SDK integrated into the application, there will be no events to send to the webhook.

How long does it take to configure the integration?​

After sending the necessary information (webhook endpoint, cell IDs) to our team, the configuration is completed within 2 business days.

About the SDK​

Which SDK should I integrate?​

You should integrate the SDK according to your application's platform:

  • Native Android: Android SDK
  • Native iOS: iOS SDK
  • React Native: React Native SDK
  • Flutter: Flutter SDK

You can integrate on multiple platforms if your application is available on more than one.

Where can I find the SDK documentation?​

Complete SDK documentation is available at SDK Documentation.

Does the SDK work in the background?​

Yes, the Group Link SDK works in the background to detect entry events in monitored areas, respecting the limitations of each platform (iOS/Android).

About H3 Cells​

What are H3 cells?​

H3 cells are hexagons that represent specific geographic areas using Uber's H3 spatial indexing system. Each cell has a unique identifier.

How do I choose which H3 cells to monitor?​

You can:

  1. Use online tools like H3 Geo to explore and identify cells
  2. Provide geographic coordinates (latitude/longitude) and our team will convert them to Cell IDs
  3. Request help from our team to identify the correct cells

Can I monitor multiple cells?​

Yes, you can monitor as many H3 cells as you want. Just provide the list of Cell IDs in the configuration.

Can I add or remove cells later?​

Yes, you can request changes to monitored cells by contacting our team via email suporte@grouplinkone.com.

About the Webhook​

Does my webhook need authentication?​

Currently it is not mandatory, but we recommend preparing your endpoint to receive authentication via API Key in the header, as this functionality will be implemented soon.

What type of request is sent to the webhook?​

  • HTTP Method: POST
  • Content-Type: application/json
  • Body: JSON with event data

Does my endpoint need to return something specific?​

Your endpoint should return an HTTP 2xx status (200, 201, 204, etc.) to confirm that it received the event. The response content is not important, only the HTTP status.

What happens if my endpoint is down?​

If your endpoint returns an error or is inaccessible, we will try to resend the event:

  • Attempt 1: After 1 minute
  • Attempt 2: After 5 minutes
  • Attempt 3: After 15 minutes

After 3 unsuccessful attempts, the event will be discarded.

Can I receive duplicate events?​

In rare cases (such as retries after timeout), you may receive the same event more than once. We recommend implementing idempotency using the combination of mm + created_at + event_type + cell_id.

What is the expected webhook response time?​

We recommend that your endpoint respond in less than 5 seconds. Best practice is to return 200 OK immediately and process the event asynchronously.

About Events​

What types of events are sent?​

The event types that exist are:

  • EVENT_IN: When the user enters a monitored area

How often are events sent?​

Events are sent in real-time as soon as detected by the SDK. Frequency depends on user movement in monitored areas.

What is the latency between the actual event and webhook receipt?​

Normally a few seconds, but may vary depending on the mobile device's connectivity.

How do I identify which user generated the event?​

The mm field is a unique pseudonymous identifier per device. If you need to associate it with a specific user in your system, you can implement user identification through the SDK (see SDK documentation for User Identification).

What is the origin field in events?​

The origin field indicates how the event was detected:

  • "beacon": Detection via Bluetooth beacon
  • "gps": Detection via GPS
  • "network": Detection via network (Wi-Fi/Cellular)

Privacy and Security​

Is user data secure?​

Yes. The SDK does not access users' personal information. Only anonymized geolocation data is collected to detect entry/exit events in monitored areas.

Is the mm (device identifier) reversible?​

No. The mm is a one-way hash of the device ID, ensuring user privacy.

Does the webhook use HTTPS?​

Yes, we require that your webhook endpoint use HTTPS to ensure data transmission security.

Testing and Debugging​

How can I test if the integration is working?​

  1. Make sure the SDK is integrated and running in your app
  2. Use the device itself with the app installed
  3. Physically visit one of the monitored areas (configured Cell IDs)
  4. Check if events are arriving at your webhook

How do I debug problems with events not being received?​

Check:

  1. Is the SDK correctly integrated and initialized in the app?
  2. Does the app have the necessary permissions (location, bluetooth)?
  3. Are you actually inside the monitored H3 cell area?
  4. Is your webhook endpoint accessible and responding correctly?
  5. Check your endpoint logs to see if requests are arriving

Can I see a log of sent events?​

Contact our team at suporte@grouplinkone.com to request event logs for debugging.

Costs and Limits​

Is there a limit to the events I can receive?​

There is no technical limit imposed by us. The number of events depends on how many users of your application transit through the areas.

How does billing work?​

Contact our sales team for information about costs and plans.

Support​

I didn't find the answer to my question. What should I do?​

Contact our support team:

Our team responds within 1 business day.

Where can I find more technical documentation?​